Inside Macintosh: QuickDraw GX Graphics /

Chapter 2 - Geometric Shapes / Geometric Shapes Reference

Functions / Getting and Setting Shape Geometries

GXSetPoint

You can use the GXSetPoint function to change the geometry of an existing point shape.

void GXSetPoint(gxShape target, const gxPoint *data);

target

A reference to the point shape whose geometry you want to change.

data

A pointer to the new point geometry.

DESCRIPTION

The GXSetPoint function copies the geometry information from the data parameter into the geometry property of the target point shape. If the target shape is not a point shape, this function replaces the target shape with a point shape and sets the shape fill to open-frame fill.

You must provide a pointer to a gxPoint structure in the data parameter--if you pass nil for the data parameter, the function posts the error parameter_is_nil.

If the target shape is locked (that is, its gxLockedShape shape attribute is set), this function posts the error shape_access_not_allowed.

ERRORS, WARNINGS, AND NOTICES

Errors
out_of_memory
shape_is_nil
parameter_is_nil	(debugging version)
shape_access_not_allowed	(debugging version)

SEE ALSO

For general information about point geometries, see "Point Shapes" on page 2-16.

For the definition of the gxPoint structure, see page 2-104.

To create a new point shape, use the GXNewPoint function, which is described on page 2-111.

To examine the geometry of an existing point shape, use the GXGetPoint function, which is described on page 2-121.

To draw a point geometry without creating a point shape, use the GXDrawPoint function, which is described on page 2-158. To draw a point shape, use the GXDrawShape function, which is described in the chapter "Shape Objects" in Inside Macintosh: QuickDraw GX Objects.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help